Skip to content

[strategist] planning: v4→v5 forward-port sync policy (src/docs/v5-sync-policy.md) - #6052

Merged
clubanderson merged 2 commits into
v4from
strategy/v5-sync-policy
Sep 5, 2026
Merged

[strategist] planning: v4→v5 forward-port sync policy (src/docs/v5-sync-policy.md)#6052
clubanderson merged 2 commits into
v4from
strategy/v5-sync-policy

Conversation

@kubestellar-hive

@kubestellar-hive kubestellar-hive Bot commented Sep 5, 2026

Copy link
Copy Markdown
Contributor

Summary

Documents the active v4→v5 forward-port sync policy and aligns it with the current merge-commit top-up practice used by #5845, #6046, and #6053.

The policy now states:

  • cadence: after every v4 release tag, and at least weekly;
  • ownership: maintainers own syncs, while the ci-maintainer agent may open or refresh the sync PR;
  • procedure: merge current v4 into current v5, re-applying v4 intent into v5 refactored layout and keeping v5-specific version/tag/image-channel policy;
  • verification: go test -race ./pkg/... ./cmd/..., kick-governor tests, docs-link check, required checks, and DCO;
  • zero-delta confirmation: git rev-list --count origin/v5..origin/v4.

Validation: python3 src/scripts/check-docs-links.py passed.

Closes #6051

Adds src/docs/v5-sync-policy.md proposing cadence (v4 minor release or
50-commit drift), single-owner rotation, the merge-commit top-up
procedure already used by #5845/#6046, DCO expectations, and explicit
PR-body and review contracts for sync PRs. Links it from the docs index.

Refs #6051

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Signed-off-by: sec-check <sec-check@hive.kubestellar.io>
@kubestellar-hive kubestellar-hive Bot added the hold label Sep 5, 2026
@kubestellar-prow kubestellar-prow Bot added dco-signoff: yes Indicates the PR's author has signed the DCO. size/L Denotes a PR that changes 100-499 lines, ignoring generated files. labels Sep 5, 2026
Align the v4-to-v5 sync policy with the current merge-commit top-up process, weekly/release cadence, maintainer ownership, verification checklist, and zero-delta check.

Closes #6051

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Signed-off-by: Andy Anderson <andy@clubanderson.com>
@clubanderson clubanderson added no-changelog No changelog fragment required and removed hold labels Sep 5, 2026

@clubanderson clubanderson left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewed the docs against the current v5 sync history and updated the policy to match the merge-commit top-up process, cadence, ownership, verification checklist, and zero-delta check.

@clubanderson

Copy link
Copy Markdown
Member

/lgtm
/approve

@kubestellar-prow kubestellar-prow Bot added the lgtm Indicates that a PR is ready to be merged. label Sep 5, 2026
@kubestellar-prow

Copy link
Copy Markdown
Contributor

LGTM label has been added.

DetailsGit tree hash: 5893a9835f71bc62168b31954c3631f0058a1c12

@kubestellar-prow

Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: clubanderson

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@kubestellar-prow kubestellar-prow Bot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Sep 5, 2026
@clubanderson
clubanderson merged commit e3010a2 into v4 Sep 5, 2026
52 of 55 checks passed
@clubanderson
clubanderson deleted the strategy/v5-sync-policy branch September 5, 2026 05:33
@github-actions

github-actions Bot commented Sep 5, 2026

Copy link
Copy Markdown
Contributor

Thank you for your contribution! Your PR has been merged.

We'd love to hear how your experience was: share feedback

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

approved Indicates a PR has been approved by an approver from all required OWNERS files. copilot dco-signoff: yes Indicates the PR's author has signed the DCO. lgtm Indicates that a PR is ready to be merged. no-changelog No changelog fragment required size/L Denotes a PR that changes 100-499 lines, ignoring generated files.

Projects

None yet

1 participant